home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
ronm_b16.zip
/
RONMAIL.DOC
< prev
next >
Wrap
Text File
|
1991-12-14
|
21KB
|
715 lines
R o n M a i l
v1.0ß16
A QWK Compatible Mail Door
for
PCBoard v14.5
Copyright (C) 1991 Ron Pierce and FeatherNet Software
TABLE OF CONTENTS
-----------------
Introduction ...................................................... 2
RonMail Features .................................................. 3
Disclaimer ........................................................ 4
Registration Information .......................................... 5
Installing RonMail ................................................ 6
Configuring RonMail ............................................... 7
Command Summary ................................................... 8
File Transfer Protocols ........................................... 9
Fossil Driver Usage ............................................... 10
ShareWare Registration Form ....................................... 11
RonMail v1.0ß16 - Page 1
┌────────────┐
│Introduction│
└────────────┘
RonMail allows you to upload and download mail. You may read and reply
to mail with any of the offline reader programs including EZ-Reader and
SLMR (Silly Little Mail Reader). The advantage of reading and replying
to mail offline is obvious - you save your time on the bbs and can reply
or write new messages at your leisure.
RonMail requires the use of MS/PC-DOS version 3.0 or higher and that the
dos utility "SHARE.EXE" is loaded prior to RonMail being run.
RonMail will run on all types of PC-compatible computers.
┌────────────┐
│ Warning │
└────────────┘
Any reverse engineering or altering of the 'code' in any form is expressly
forbidden and thus illegal.
PCBoard is a registered trademark of Clark Development Co., Inc.
Mark Herring (SparkWare) conceived and developed the "QWK" message format.
*** A Word from the Author ***
I am open for suggestions. Source code is available thru a non-
disclosure agreement for anyone seriously interested in a joint
QWK door project to add enhanced features. RonMail is written
in MS QuickBASIC version 4.5 and is enhanced by assembly calls.
RonMail v1.0ß16 - Page 2
┌────────────┐
│ Features │
└────────────┘
o Allows users (local and remote) to download new mail packets
o Allows users (local and remote) to upload new mail packets
o Optionally (Sysop .CFG Option) updates mail waiting flags in USERS.INF
and USERS so PCBoard will know a user on your system has received new mail
o Allows sysop to authorize New file descriptions to be downloaded
o Allows new bulletins to be downloaded
o New files listing from the conference the user opened RonMail from may be
received if the sysop allows this. Sysop may allow all files or uploads
only. Private upload directories will never be scanned.
o Sysop defined maximum messages to be downloaded by baud rate
o Maintains a record of number of messages captured daily.
o Allows Bi-Directional protocols to be used
o User configuration allows:
o Capture of ONLY mail addressed to the user
o Capture of mail addessed to ALL may be toggled on or off
o Capture of mail 'YOU' wrote may be toggled on or off
o Setting of high/low message read pointers to the HIgh message number,
low message number, or any message number between these two values
o Toggle to receive or not to receive New bulletins
o Toggle to receive New file descriptions or not (Sysop must turn this
function on before the user's setting has any affect)
o Selecting conferences to scan for new mail.
o All the above listed user options
o Times in RonMail
o Number of Downloaded Packets
o Number of Uploaded Packets
o Last Date and Time user entered RonMail
o Updates the USERS.SYS high message read flags when exited or the user logs
off with the (G) command. (Sets the 'Dirty' flag so PCBoard knows)
o Support for DG or UG (D/L or U/L and Goodbye) commands from main menu
o Writes user's statistics (W)
o Allows changing graphics mode (M)
o Operator page (O) if activated by sysop (ESC Begins chat after Page)
o Chat function incorporated (F10 = Sysop Invoked Chat)
o ESC terminates chat
o User help file available (H)
o Swaps occupied dos memory out to EMS, XMS, or to Disk during all ZIP
functions, file transfers, and when a dos shell (F5) is executed
(if the Sysop desires)
RonMail v1.0ß16 - Page 3
┌────────────┐
│ DISCLAIMER │
└────────────┘
WARNING! I, Ron Pierce, cannot accept any responsibility for loss, personal
or commercial, incurred while operating RonMail. You operate RonMail at
your own risk.
I make no warranty of any kind, express or implied, including without
limitation, any warranties of merchantability and/or fitness for a
particular purpose. I shall not be liable for any damages, whether
direct, indirect, special or consequential arising from a failure of
this program to operate in the manner desired by the user. I shall
not be liable for any damage to data or property which may be caused
directly or indirectly by the use of this program.
IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES,
INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.
RonMail v1.0ß16 - Page 4
┌────────────┐
│Registration│
└────────────┘
RonMail is Shareware. You may evaluate RonMail for a period of
30 days after which you should register the program or discontinue
using it.
Many hours of programming, debugging and testing have gone into the
development of this program. Therefore the program is being
distributed in a reduced capacity demo mode. Once you decide
to register RonMail you will be given a registration number which
will enable its full operation.
To register RonMail and continue to promote the development of
affordable Shareware programs, fill out the Registration form at
the end of the documentation and send it with your payment to:
Ron Pierce
2001 Leyte Rd.
Ridgecrest, CA. 93555
Payment must be in the form of check or postal money order drawn
in US funds.
The support bbs phone number(s) are:
(619)446-4505 (2400 Buad only)
(619)446-4506 (USR Dual Standard 14.4k Baud, HST, v.32, v.42bis
When we have received and processed your registration, your registration
number will be available for download from the support BBS as a personal
and private download. Ensure you annotate on the registration form your
preference of (1) calling the support bbs for the registration number or
(2) having the registration number mailed to you.
Below are the limitations of the RonMail Until Registered:
o UNREGISTERED notice displayed when door is entered.
o Maximum of 100 Messages may be captured per day
RonMail v1.0ß16 - Page 5
┌────────────┐
│Installation│
└────────────┘
First, create a subdirectory to hold your RonMail program files, such
as C:\PCB\RONMAIL. Extract the files from the RONMAL10.ZIP file into
this new directory. Of course, you should have PKZIP and PKUNZIP
available in the RonMail directory, or better, somewhere in your DOS
PATH.
You should now find the following files in your RonMail directory:
RONMAIL.EXE - The Main Program File
RONMAIL.DOC - This Documentation File
RONMAIL.MEN - ASCII Menu File
RONMAILG.MEN - ANSI Menu File
RONMAIL.HLP - User "HELP" file for RonMail
RONMAIL - Sample Door Batch File for RonMail
HISTORY.TXT - List of modifications, bug fixes and new versions
MAILPROT.DAT - Sample File Transfer Protocol Data File
SAMPLE.CFG - Sample Configuration File
SCROLL.COM - Preserves the status line during transfers
Copy the file "RONMAIL" into each NODE directory.
This version of RonMail requires a 'fossil driver such as BNU or X00
for serial communications support.
During local mode or when the door is entered during a keyboard logon of
the bbs, packets are downloaded and uploaded by copying from and to the
available drives and directories on the computer.
You Should also ensure you place the path & name of the Comm Driver batch
file in the configuration file. This is sometimes needed by sysops running
under DesqView. This batch file must contain the command to reinitialize
the fossil driver you use.
A sample comm driver batch file named BNU2.BAT is:
@echo off
bnu /I=0+
This would reinitialize the fossil driver for comm port #1 after a file
transfer. It is recommended you use this batch file even if you are not
running under DesqView.
PCBoard Configuration Requirements
----------------------------------
You must use "PCBSM.EXE" to add a TPA to the 'users.inf' file for RonMail.
Name this TPA "RONMAIL". The "static" record size MUST be "25" bytes and
the "dynamic" record size MUST be "0" bytes. For the "Keyword" enter
"RONMAIL". RonMail uses its 25 bytes to store each user's configuration
and other data pertinent to its operation.
RonMail relies on PCBoard's USERS.SYS file for all high message read
pointers and the user's joined and scan flags.
RonMail v1.0ß16 - Page 6
┌─────────────┐
│Configuration│
└─────────────┘
Edit the "RONMAIL" file in each NODE directory to match your NODE
path and save. For example if a NODE is in C:\PCB\NODE1 and the
RONMAIL directory is C:\PCB\RONMAIL the "RONMAIL" file in the NODE
directory will be:
C:
CD\PCB\RONMAIL
RONMAIL RONMAIL.CFG << Use any legit ".cfg" file name you desire
C:
CD\PCB\NODE1
BOARD
Since RonMail supports multiple nodes, ensure you have a unique name
for the ".cfg" file for each node.
You must now create the configuration files for each node. These files
MUST reside in the RONMAIL directory. Be extremely cautious to ensure
the files are created exactly as defined below.
PROGINN ; BBS ID Code. Always 8 or fewer Characters.
RidgeCrest, CA ; Location of BBS
619-446-4506 ; BBS Telephone Number
The Programmer's Inn ; Name of bbs (as Registered)
Ron Pierce ; Sysop's Name
C:\PCB ; PCBoard NODE Directory for this .cfg file
J:\WORK ; Door "WORK" Directory (RAM disk recommended)
Y ; "Y" to swap to EMS, XMS, or Disk during SHELLs
C:\PCB\BNU2.BAT ; Path/name of batch file to initialize fossil
000.0000 ; Door Registration Number
Y ; "Y" to allow D/L of New FIles Descriptions
N ; "Y" = Scan Upload DIR only for new files
C:\PCB\RONMAIL\MAILPROT.DAT ; File Transfer Protocol data file Path and Name
Y ; "Y"= Update mail waiting flags (v1.3 supports)
C:\PCB\GEN\WELC ; "WELCOME" file PATH AND NAME
C:\PCB\GEN\NEWS ; "NEWS" file PATH AND NAME
C:\PCB\GEN\SCRIPT0 ; "GOODBYE" file PATH AND NAME
1 ; Enter the Node Number (1 - 99)
100 ; Max messages to capture for 300 baud callers
200 ; Max messages to capture for 1200 baud callers
300 ; Max messages to capture for 2400 baud callers
500 ; Max messages to capture for 4800 baud callers
3000 ; Max messages to capture for 9600 baud callers
3000 ; Max messages to capture for 14.4k baud callers
4 ; Number of archivers to allow
PkZIP and PkunZIP ; Name/Description of 1st Archiver
C:\PKUNZIP ; Path/Command to Un-Archive a mail reply (.REP)
C:\PKZIP -ex -a ; Path/Command to archive a mail packet (.QWK)
LHA (formerly LHARC) ; Continue for number of archivers used
C:\LHA e
C:\LHA a /m
ARJ - Excellent
C:\ARJ e
C:\ARJ a
Old PKXarc format (arc)
C:\PKUNPAK
C:\PKPAK -a
Programmer's Inn - Home of FeatherNet (619)446-4506 ; Tag Line (54 Char max)
RonMail v1.0ß16 - Page 7
WARNING
-------
The "WORK" directory MUST NOT be used to store any files. It must be
exclusively used by RonMail. All files in this directory are routinely
deleted by RonMail. For optimum speed it is recommended you use a RAM
disk as the "WORK" directory.
The following are commands available to users of the RonMail door.
There are no Sysop specific commands.
Command Summary
---------------
(C) Configure RonMail for your needs. Select conferences to include
in your mail packet.
o Set Last Message Read Pointers.
o Select conferences to be scanned.
o Select archive format to compress/decompress your packets (for users)
o Toggle to receive mail addressed to you only.
o Toggle to receive mail addressed to 'ALL'.
o Toggle to receive mail you wrote.
o Toggle to receive any NEW bulletins.
o Toggle to receive a listing of NEW files (if sysop allows this)
(D) Download a .QWK packet. If there is any new mail for you it will
be processed and prepared for downloading to your system.
(DG) Download a packet and immediately logoff.
(M) Toggle Graphics mode from ANSI Color to Pure ASCII or vice versa.
You should ascertain your terminal supports ANSI graphics before
using this command. If you toggle the graphics mode and see ' ['
or similar characters then use the command again to return to
normal ASCII text mode.
(O) Operator Page for chat.
(Q) Quit the door and return to PCBoard
(U) Upload a .REP packet.
(UG) Upload a packet and immediately logoff.
(W) Write your door statistics.
o Times in door.
o Packets Downloaded
o Packets Uploaded
o Last Date & Time in door.
o Archive Method currently selected by user
(?) Re-Displays the main menu file.
RonMail v1.0ß16 - Page 8
┌─────────────────────────┐
│ File Transfer Protocols │
└─────────────────────────┘
RonMail exclusively uses external file transfer protocols. You may specify
up to 25 file transfer protocols configured. This is an arbitrary limit.
You you find yourself needing or wanting to configure RonMail to utilize
more than 25 protocols, contact me at the support bbs.
A configuration for some is in the file 'mailprot.dat'. Note that NON
bi-directional protocols MUST NOT have the paths to which the .REP files
are to be received on the command lines (lines 2 and 3 of each protocol's
definition).
IF you are defining a bi-directional protocol for RonMail ensure you do
include the path to the WORK directory on the command lines in your
'mailprot.dat' file. Though two command lines are used for bi-directional
protocols, I realize this is probably not necessary. It is done for file
formatting simplicity.
The file transfer definition ('mailprot.dat') file is formatted as described
below. A sample file is shown and then each line of the file is detailed.
2
Z01Zmodem (Resume Capability) - Still Great!
DSZ ha cts port 1 pB4096 sz -s -m
DSZ ha cts port 1 pB4096 rz -m -rr
B11Bimodem Bi-Directional Transfers + Chat
C:\bim\Bimodem /CC:\bim\fnmail1.cfg /UJ:\WORK\PROGINN.QWK /DJ:\WORK\PROGINN.REP
C:\bim\Bimodem /CC:\bim\fnmail1.cfg /UJ:\WORK\PROGINN.QWK /DJ:\WORK\PROGINN.REP
Line 1: The number "2" means there are 2 external protocols being configured
for use with RonMail
Line 2: Z - Letter (HOTKEY) to select this protocol
1 - Use a 1 if the protocol is bi-directional or a 0 if not.
1 - Use a 1 or a 0 - reserved for future use
Line 3: The command line to send files with this protocol
Line 4: The command line to receive files with this protocol
Line 5: Repeat of line 2 for 2nd protocol
Line 6: Repeat of line 3 for 2nd protocol
Line 7: Repeat of line 4 for 2nd protocol
Notice
------
o For Bimodem, HS/Link or any Bi-Directional transfer protocol, you
must specify the work directory and .QWK file name to be downloaded
on the command line as done above in the sample BIMODEM and HSLINK
entries. This could be done in a series of batch files for each
protocol but I think overall this is easier.
o Non bi-directional protocols are passed the path and name of the .QWK
packet so they DO NOT need the path/name of the .QWK packet on the
command line.
o RonMail expects the .REP files to be in the defined work directory
after the transfer is completed.
RonMail v1.0ß16 - Page 9
┌─────────────────────┐
│ Fossil Driver Usage │
└─────────────────────┘
RonMail currently employs the use of a "fossil" driver for serial
I/O. Depending on the fossil driver you use, you can utilize from
1 to 8 comm ports with a fossil driver with non-standard port usage
covered thoroughly in the fossil driver's documentation.
I use the BNU fossil. Another excellent one is X00. Both work well.
It is recommended you either add the fossil driver initialization
commands to your PCBoard "BOARD.BAT" file or in the RONMAIL door batch
file. I recommend it be placed in your BOARD.BAT file prior to PCB145
being run.
To initialize BNU place an entry in your batch file of choice similar
to the one below:
BNU /T=3072 /R=4096 /L:0=19200,8N1 /O /M-
BNU /i=0+
The number specified in the fossil driver initialization is the number
of the comm port you are using minus 1. The above initialization is
actually for comm port #1. Refer to fossil documentation for further
information.
RonMail v1.0ß16 - Page 10
RonMail - A QWK Compatible Mail Door for PCBoard
(C) Copyright 1991 Ron Pierce and FeatherNet Software
All Rights Reserved
Shareware Registration Form
Mail to: Ron Pierce, 2001 Leyte Rd., RidgeCrest, CA. 93555, USA
Please make check or postal money order payable in US funds to Ron Pierce
Signature:__________________________________________________
Name:__________________________________________________
Address:__________________________________________________
:__________________________________________________
Phone:___________________
__ RonMail Registration (US funds)........... @ $25.00 ea $ ______
(Checks or Money orders ONLY)
__ I desire the registration number to be mailed to me... $ ______
( $1.00 if outside USA )
I acquired RonMail from ( )Friend ( )Computer Club
( )BBS:_______________________ ( )Other__________________________